Skip to content

Add June 2025 meeting notes #158

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 3 commits into from
Jun 23, 2025
Merged

Add June 2025 meeting notes #158

merged 3 commits into from
Jun 23, 2025

Conversation

hugovk
Copy link
Member

@hugovk hugovk commented Jun 13, 2025


📚 Documentation preview 📚: https://docs-community--158.org.readthedocs.build/

[Adam]: I did go through and get a list of issues re: how our model differs from RtD
expectations, I might have another go at figuring out how to reconcile the approaches.

[Carol]: We need to involve the relevant people - Manuel, Adam, Petr, release managers,
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hi 👋🏼 , I'm Manuel from Read the Docs and I just saw this comment here. I wasn't being able to participate in the meetings lately, but I've been reading all these notes. So, here I am 😄

We made some progress some time ago with Hugo, Carol and other folks. Currently there is a CPython project that builds the previews every time a push is done:

It makes usage of the Read the Docs Addons API through this file https://github.com/python/cpython/blob/f0799795994bfd9ab0740c4d70ac54270991ba47/Doc/tools/static/rtd_switcher.js to generate the version and language selectors.

Besides, we did some tests with the Spanish translation as well:

We've also enabled some cool features like "Visual Diff" that shows the differences between the PR and the default version of the docs and lists of all the files that were changed. Here you have a small example https://cpython-previews--134377.org.readthedocs.build/en/134377/library/dataclasses.html?readthedocs-diff=true&readthedocs-diff-chunk=4

Screenshot_2025-06-16_16-58-08

All these conversations happened in Discord under the #infra channel inside a thread named RTD for the Python docs. Feel free to ping me here or there if you want to continue this conversation in case of clarification of any doubts or coordination ❤️

hugovk and others added 2 commits June 23, 2025 15:11
@hugovk hugovk merged commit ffe4809 into python:main Jun 23, 2025
3 of 4 checks passed
@hugovk hugovk deleted the june branch June 23, 2025 12:20
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants